Quickstart React Native

Este guia irá ajudá-lo a implementar o Group Link Mobile SDK em sua aplicação escrita para o framework React Native.

Passo 1 - Instalando o SDK

Dentro da pasta raiz do seu projeto, cole uma das seguintes linhas no seu terminal.

npm i @grouplinknetwork/rn-grouplink-sdk

yarn add @grouplinknetwork/rn-grouplink-sdk

Passo 2 - Configurar as permissões

Será necessário declarar as permissões dentro do seu Android manifest (dentro da pasta android/app/src) e no seu info.plist (você pode encontrar este arquivo dentro da pasta ios).

você pode seguir o manual de Permissões Necessárias no Android e Permissões Necessárias no iOS para saber mais.

Caso configure os arquivos nativos pelo seu app.json adicione essas permissões:

"android":{
  "permissions": [
          "INTERNET",
          "ACCESS_FINE_LOCATION",
          "ACCESS_COARSE_LOCATION",
          "BLUETOOTH_ADMIN",
          "ACCESS_WIFI_STATE",
          "FOREGROUND_SERVICE",
          "BLUETOOTH_SCAN",
          "BLUETOOTH_ADVERTISE",
          "BLUETOOTH_CONNECT",
          "POST_NOTIFICATIONS"
        ]
}

"ios": {
      "infoPlist": {
        "NSBluetoothAlwaysUsageDescription": "Nós precisamos da permissão de bluetooth para uma melhor experiencia de usuario",
        "NSBluetoothPeripheralUsageDescription": "Nós precisamos da permissão de bluetooth para uma melhor experiencia de usuario",
        "NSLocationAlwaysAndWhenInUseUsageDescription": "Nós precisamos da permissão de localização para uma melhor experiencia de usuario",
        "NSLocationWhenInUseUsageDescription": "Nós precisamos da permissão de localização para uma melhor experiencia de usuario",
        "UIBackgroundModes": [
          "bluetooth-peripheral",
          "location",
          "bluetooth-central",
          "processing",
          "fetch"
        ],
        "BGTaskSchedulerPermittedIdentifiers": [
          "com.grouplinknetwork.bgtask"
        ]
      }
    }

Passo 3 - Configurar o SDK

Para inicializar nosso SDK nas plataformas Android e iOS, você pode usar a seguinte abordagem:

import * as GroupLinkSDK from '@grouplinknetwork/rn-grouplink-sdk';

export default function App() {
  useEffect(()=>{
        // Esta função requer o Token do Group Link da sua organização e 
        // aceita um valor booleano para determinar sua depurabilidade.
        GroupLinkSDK.startGrouplink("GROUP_LINK_TOKEN", isDebuggable);
    },[])
  return (
    <View style={styles.container}>
      <Text>Este é um aplicativo de teste</Text>
    </View>
  );
}

Nós detectamos automaticamente a plataforma que você está usando e invocamos os métodos apropriados para a inicialização do SDK.

No entanto, se você deseja inicializar o SDK em uma única plataforma, pode usar o seguinte método:

Para iOS -

import * as GroupLinkSDK from '@grouplinknetwork/rn-grouplink-sdk';

export default function App() {
useEffect(()=>{
        // Esta função requer o Token do Group Link da sua organização
        GroupLinkSDK.startGrouplinkIOS("GROUP_LINK_TOKEN");
    },[])
  return (
    <View style={styles.container}>
      <Text>Este é um aplicativo de teste</Text>
    </View>
  );
}

Para Android -

import * as GroupLinkSDK from '@grouplinknetwork/rn-grouplink-sdk';

export default function App() {
  useEffect(()=>{
        // Esta função requer o Token do Group Link da sua organização e 
        // aceita um valor booleano para determinar sua depurabilidade.
        GroupLinkSDK.startGrouplinkAndroid("GROUP_LINK_TOKEN", isDebuggable);
    },[])
  return (
    <View style={styles.container}>
      <Text>Este é um aplicativo de teste</Text>
    </View>
  );
}

Próximos Passos

Agora que você inicializou com sucesso o Group Link SDK dentro do seu aplicativo, você deve seguir o código específico para iOS e Android.